home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Diamond Collection / The Diamond Collection (Software Vault)(Digital Impact).ISO / cdr36 / dualdos.zip / README.TXT < prev    next >
Text File  |  1995-02-28  |  18KB  |  485 lines
  1. Welcome to the Demo Version of the IBM DualStor Backup Program
  2. for DOS Version 2.0!
  3.  
  4. All operations of the DualStor for DOS program are enabled with this
  5. Demo version EXCEPT the Restore operation.  You can Select the
  6. Restore operation but after you enter the Restore parameters, you
  7. will receive a message indicating the Restore operation is disabled.
  8. To install this Demo version, insert the DualStor for DOS diskette
  9. in a 3.5" floppy drive and enter 'x:setup' where x=your 3.5" floppy
  10. drive designator (for example, a:setup).
  11. After DualStor for DOS is installed, enter 'dualstr' from the 'x:\DUALSTOR\'
  12. command prompt to start the DualStor application.
  13. We hope you like DualStor!  If you would like to purchase DualStor for
  14. DOS you can call Options by IBM at 1-800-426-7299 (US Only) or IBM
  15. Direct at 1-800-465-7999 (Canada Only).  
  16. DualStor for DOS and DualStor for Windows versions 2.0 are packaged together.
  17. You also may be interested in purchasing the DualStor 450 Tape Drive which
  18. can store up to 450 meg of data when using a Sony QIC-wide tape QW5122XL
  19. and level 2 compression (data dependent).
  20.  
  21. DualStor part numbers:
  22. 11H1594  DualStor for DOS/Windows version 2.0 (software only)
  23. 11H1504  DualStor for DOS/Windows version 2.0 and DualStor 450 Tape Drive
  24.          (hardware, software, & 1 Sony QIC-wide QW5122XL tape cartridge)
  25. 11H1568  DualStor for OS/2 version 2.0 (software only)
  26. 11H1505  DualStor for OS/2 version 2.0 and DualStor 450 Tape Drive
  27. 11H1571  Upgrade from DualStor for DOS/Windows 1.0x
  28. 11H1549  Upgrade from DualStor for OS/2 1.0x
  29.  
  30. The following is the README that ships with the product.
  31.  
  32. -------------------------------------------------------------------
  33. TABLE OF CONTENTS
  34.   1 - DualStor Execution
  35.   2 - DualStor and DOS
  36.   3 - DualStor Job (Parameter) Files
  37.   4 - DualStor and Networks
  38.   5 - Compatibility with Other Software and Hardware
  39.   6 - DualStor 2.0 Changes from Versions 1.x
  40.   7 - Miscellaneous
  41.   8 - Errorlevel Return Codes for Batch Files
  42.  
  43. ----------------------------------------------------------------------
  44.   1 - DUALSTOR EXECUTION
  45. ----------------------------------------------------------------------
  46.  
  47.  
  48. ----------
  49. *Incremental vs. Differential Backup Methods*
  50.  
  51. The only difference between Incremental and Differential backups
  52. is the Incremental method will reset the archive bits and the
  53. Differential does not reset the archive bits.  Both methods
  54. will back up the same files from your hard disk based on the
  55. archive bit.  Checked files that have the archive bit set on
  56. will be backed up.
  57.  
  58. ----------
  59. *Printing in DualStor*
  60.  
  61. At this time, DualStor can print files to disk, but not to a printer.
  62. To work around this limitation, select Print from the File menu,
  63. select OK, and name the file you want to save on disk. At a DOS
  64. prompt, type PRINT FILENAME. For more information on printing from the
  65. DOS prompt, see your DOS documentation.
  66.  
  67. ----------
  68. *AutoTape Command Prompt*
  69.  
  70. When entering a command in the AutoTape command box, be sure to use
  71. the extension of the file being used so that the operation will work
  72. properly. For example:
  73.  
  74.         DUALSTR.EXE FULL-CDE.TPF
  75.  
  76. ----------
  77. *~BEX Files*
  78.  
  79. Files that begin with ~BEX are temporary files used by DualStor. If
  80. you see one of these files when DualStor is not running, you can
  81. delete them. ~BEX files will be found either in your TEMP directory or
  82. your DualStor directory.
  83.  
  84.  
  85. ----------
  86. *Ignoring Drives in DualStor*
  87.  
  88. You can tell DualStor to ignore specified drives, if you have non-
  89. existent drives that are creating error messages or speed problems when
  90. you run DualStor. For example, if you have a computer with a single
  91. floppy drive (drive A:), you can have DualStor ignore your non-existent
  92. drive.  You may also want to use this setting to tell DualStor to ignore
  93. both A: and B: drives so that they do not appear in your DualStor Drives
  94. window.  The default Drives selection would then always be your C:
  95. drive.
  96.  
  97. To do this, add the following command to the DUALSTR section of your
  98. DUALSTR.INI file (located in your DUALSTOR directory).
  99.  
  100.         IRSKIPDISK=ab
  101.  
  102. You can list as many drive letters as you want, putting no spaces
  103. between them, for example, IRSKIPDISK=abcd (to ignore your A:, B:,
  104. C:, and D: drives).
  105.  
  106. You can achieve the same thing by putting a SET statement in your
  107. AUTOEXEC.BAT file. The syntax is:
  108.  
  109.         SET IRSKIPDISK=abcd
  110.  
  111. ----------------------------------------------------------------------
  112.   2 - DUALSTOR AND DOS
  113. ----------------------------------------------------------------------
  114.  
  115. *DualStor in the Windows and OS/2 Presentation Manager Environments*
  116.  
  117. Do not attempt to run DualStor from a DOS window or full screen in
  118. either Windows or OS/2. If you do so, the program will either halt or
  119. run very slowly. You can purchase a DualStor product that is designed
  120. specifically for your operating environment. Consult your dealer for
  121. information about DualStor for Windows or DualStor for OS/2.
  122.  
  123. ----------
  124. *DOS Memory Management and DualStor*
  125.  
  126. To get the best performance with DualStor you should use Upper
  127. Memory Blocks (UMBs).  Refer to the chapter, 'Optimizing Your
  128. System' in your DOS documentation for information on using
  129. UMBs.
  130.  
  131. If you have UMB enabled and you are experiencing memory
  132. management problems with DualStor for DOS try entering the
  133. following command at the DOS prompt before starting DualStor.
  134.  
  135.         SET NOUMBSUPP=1
  136.  
  137. You could add the following statement to your AUTOEXEC.BAT instead.
  138.  
  139.         SET NOUMBSUPP=1
  140.  
  141. ----------
  142. *Disk Caching and DualStor*
  143.  
  144. You will also find that DualStor will run more quickly and smoothly
  145. when there is a disk caching program installed on your system. Disk
  146. caching improves performance by storing parts of the program in the
  147. computer's memory rather than only on disk.
  148.  
  149. Most users now load a disk cache when their computer starts up.
  150. A disk cache program may be included with your DOS product and
  151. there are a number of third party programs as well. If you have more
  152. than 640K memory available, we recommend that you use part of this
  153. memory for a disk cache.
  154.  
  155. Note: DualStor does not require the use of a disk cache. However, if
  156. you do not use disk caching, you may notice that DualStor takes longer
  157. to load than expected.
  158.  
  159. ----------
  160. *Setting the TZ Environment Variable
  161.  
  162. The TZ environment variable is not compatible with either DualStor for DOS
  163. or Windows.  Having the line 'SET TZ=' in your AUTOEXEC.BAT file will cause
  164. the time based functions in DualStor to be inaccurate (ex. elapsed time will
  165. be 00:00:00 and the transfer rate will be incorrect).  It is recommended that
  166. the TZ set variable be removed from AUTOEXEC.BAT before performing a
  167. backup or restore.
  168.  
  169. If you did create backup sets with TZ enabled you will need to 'SET TZ='
  170. again before you can recover your data with DualStor.
  171.  
  172.  
  173. ----------------------------------------------------------------------
  174.   3 - DUALSTOR JOB (PARAMETER) FILES
  175. ----------------------------------------------------------------------
  176.  
  177. *Using Parameter Files from PS2Tape and PMTape*
  178.  
  179. If you have parameter files created for PS2Tape or PMTape, they will
  180. work with DualStor by copying them into the DualStor directory.
  181. Parameter files are now called job files and can be created more
  182. easily using options in the DualStor Jobs menu. Be sure that your
  183. existing parameter files have names different from the five job files
  184. created during DualStor installation (FULL.TPF, DIFFR.TPF, INCR.TPF,
  185. REST.TPF, and TAPEINFO.TPF), so you don't overwrite any of them.
  186.  
  187. Because of enhancements to job file capabilities, some of the syntax
  188. for job file commands has changed.  Your existing parameter files will
  189. still run, but first you should review Appendix B in your User Manual
  190. for detailed information on the new job file command syntax.
  191.  
  192. ----------
  193. *Logging a DualStor Operation*
  194.  
  195. All DualStor operations, including operations launched from job files,
  196. are logged in a DualStor Session Log. If you want to create a log file
  197. in a specific location with a specific name, open the job file using a
  198. text editor and add the following command:
  199.  
  200.     /l log_name
  201.  
  202. The /l command is a job file "option" available in backup and restore
  203. modes. The log file will be saved in your DualStor directory or you
  204. can specify a full path. For example:
  205.  
  206.     /l c:\bulogs\backup.log
  207.  
  208. The log file will list files that were included and/or excluded from
  209. the operation depending on the logging settings specified in DualStor.
  210. DualStor creates the log file after you exit the program. See Appendix
  211. B in the DualStor User Manual for more information on job file
  212. editing.
  213.  
  214. ----------
  215. *Mode Variables*
  216.  
  217. There is only one mode variable allowed in each Job file (i.e. *.tpf)
  218. Mode variables are !backup, !restore, !init, !util, and !shortcuts.
  219.  
  220. ----------
  221. *Encryption and Password Options*
  222.  
  223. The Encryption and Password options are not available for use with
  224. Job files.  Therefore, if you check the Encryption option in your
  225. Settings pull-down, Backup defaults window it will not be enabled
  226. (it will be grayed out) when you save a Job file.
  227.  
  228. ----------
  229. *Date Specification*
  230.  
  231. When using the '/d' option in a DualStor Job file you must have a
  232. space on both sides of the date_spec value.
  233.  
  234. ----------------------------------------------------------------------
  235.   4 - DUALSTOR AND NETWORKS
  236. ----------------------------------------------------------------------
  237.  
  238. *Novell Volume Restrictions*
  239.  
  240. Novell volume restrictions will only be backed up if you use QIC tapes
  241. with the DualStor file system or you use Servo (AccuTrak) tapes.
  242. Volume restrictions are not backed up using QIC tapes with the
  243. QIC-Compatible file system (QIC-80 and QIC-113).  See your DualStor
  244. User's Guide for more information on file systems.
  245.  
  246. ----------------------------------------------------------------------
  247.   5 - COMPATIBILITY WITH OTHER SOFTWARE AND HARDWARE
  248. ----------------------------------------------------------------------
  249.  
  250. *Intel Premiere II PCI Motherboard*
  251.  
  252. If you have a Pentium system with the Intel P90 motherboard
  253. (Premiere II PCI, codename Plato) and you are experiencing
  254. slow transfer rates, 'DMA Overruns', or excessive shoe-shining
  255. (tape spins backward and forward continuously) when performing
  256. DualStor backup operations, you should first call the Intel Bulletin
  257. Board at 916-356-3600 and search on 'BIOS' for information that
  258. could resolve these problems.
  259.  
  260. ----------
  261. *Removing Other Software Device Drivers*
  262.  
  263. If you were using another tape backup software product previous
  264. to DualStor for DOS you should remove any of its device driver
  265. entries from your CONFIG.SYS before trying to execute DualStor
  266. for DOS.
  267.  
  268. ----------
  269. *DMA Channel 2*
  270.  
  271. Prior to executing DualStor for DOS make sure you have no
  272. entries in your CONFIG.SYS that are using DMA Channel 2.
  273.  
  274. ----------
  275. *National Semiconductor Floppy Controller DP8473*
  276.  
  277. If the DualStor for DOS software detects this floppy
  278. controller on your system, the DualStor software will
  279. use a maximum transfer rate of 500Kbps (vs. 1Mbps).
  280. This is due to this floppy controller not containing a
  281. FIFO.
  282.  
  283. ----------
  284. *Compatibility with QICstream*
  285.  
  286. QICstream backup software cannot read DualStor backup sets that are
  287. compressed.
  288.  
  289. ----------
  290. *Compatibility with Colorado Memory System Backup Software*
  291.  
  292. CMS's Colorado Backup software cannot read DualStor backup sets that
  293. are compressed.
  294.  
  295. ----------
  296. *4100MC and IBM Model 9577*
  297.  
  298. The 4100MC controller card in an IBM Model 9577 will cause DualStor
  299. to work improperly. To avoid this problem, connect your tape drive to
  300. your computer's floppy controller rather than the 4100MC card. See
  301. your tape drive's installation guide for more information.
  302.  
  303. ----------
  304. *SCSI Hard Drives and the Adaptec 1540 Controller*
  305.  
  306. If you are using:
  307.  
  308.         * a tape drive with a floppy controller AND
  309.         * a SCSI hard drive with an Adaptec 1540 controller,
  310.  
  311. you must set the IROPT environment variable. To set IROPT, enter the
  312. following command at the DOS prompt before you start DualStor:
  313.  
  314.                 SET IROPT=Y
  315.  
  316. Note that the Y must be in upper case. You may include this command as
  317. part of your AUTOEXEC.BAT file.
  318.  
  319. ----------
  320. *SpeedSTAR VGA Monitor Problem*
  321.  
  322. If you are using DualStor with a SpeedSTAR VGA monitor card that has a
  323. DBIOS version 4.23, you cannot run in 43/50 line mode and graphics
  324. mode simultaneously. Select Font from the View menu, check the
  325. graphics mode check box, and leave 43/50 line mode unchecked.
  326.  
  327. ----------------------------------------------------------------------
  328.   6 - DUALSTOR 2.0 CHANGES FROM VERSIONS 1.x
  329. ----------------------------------------------------------------------
  330.  
  331. *Default Backup Set Names*
  332.  
  333. If you mark specific directories and/or files for backup as opposed to
  334. marking an entire hard drive, the default backup set name will be
  335. "Partial-X" where 'X' is the drive designator of the hard drive on
  336. which the directories and/or files marked for backup reside.  DualStor
  337. versions 1.x used a default backup set name of "Full-X".
  338.  
  339. ----------
  340. *Column Headers*
  341.  
  342. Column headers were added to the tops of the file windows.  These
  343. column headers identify the column by name (ex. "Name", "Date",
  344. etc.).  The columns can be sized by dragging the separator line
  345. between each column (the separator line to the left of "Name"
  346. is not enabled).  Click the left mouse button on any column to sort
  347. the entire list by that column.
  348.  
  349. ----------------------------------------------------------------------
  350.   7 - MISCELLANEOUS
  351. ----------------------------------------------------------------------
  352.  
  353. *Verify after Backup*
  354.  
  355. It is a good practice to check the 'Verify after Backup' option on when
  356. selecting your Backup Parameters.  This will cause DualStor to
  357. perform a byte-by-byte comparison between the data backed up on
  358. the tape and the data on the hard drive increasing your confidence
  359. in the backup.  It may, however, double the time of your backup.
  360. If you want to set this option on permanently for all of your backups,
  361. simply select the Settings pull-down, Backup..., and check the
  362. 'Verify after Backup'.
  363.  
  364. ----------
  365. *Passwords*
  366.  
  367. If you are using the QIC file system with the Password option, only 8
  368. characters are significant even though DualStor will accept 15
  369. characters.  All 15 characters are significant when using the DualStor
  370. file system.
  371.  
  372. ----------
  373. *Hardware Compression*
  374.  
  375. The DualStor User's Guide shows a Hardware Compression radio button
  376. on the Backup Set Parameters windows but you will not see it in the
  377. application itself as DualStor does not support any tape drives that
  378. support Hardware compression.
  379.  
  380. ----------------------------------------------------------------------
  381.   8 - ERRORLEVEL RETURN CODES FOR BATCH FILES
  382. ----------------------------------------------------------------------
  383.  
  384. You can use ERRORLEVEL to check the return codes of a DualStor
  385. tape operation if you are using job files and batch files.
  386. The values returned by DualStor in ERRORLEVEL are as follows:
  387.  
  388. 0  = No errors, successful completion
  389. 1  = No tape cartridge in drive
  390. 2  = Tape is full, cannot write
  391. 3  = Tape is write protected
  392. 4  = Mount failed or incompatible tape
  393. 5  = Invalid command line arguments
  394. 6  = Fatal disk error
  395. 7  = Not enough memory available to run
  396. 8  = No tape drive present
  397. 9  = User aborted operation
  398. 10 = Fatal tape error
  399. 11 = Critical verify failure, backup set deleted
  400. 12 = Internal software error
  401. 13 = Disk full on restore
  402. 14 = Disk full in \temp directory
  403. 15 = No files selected
  404. 16 = DUALSTR.MSG file not found
  405. 17 = Non-critical verify warning (Verify miscompares seen in Session log)
  406.  
  407.  
  408. The following line is an example of the contents of a job
  409. file to retension the tape first.  The 'Do not wait for errors'
  410. option is set on.  Let's call the job file RETEN.TPF:
  411.  
  412. !util /w 0 /r
  413.  
  414. The following line is an example of the contents of a job
  415. file to backup the C: drive. It will scan checked files, not wait
  416. on error, name the backup set and backup the C: drive.  Let's call
  417. the job file MYBACKUP.TPF:
  418.  
  419. !backup /m /w 0 /n "MYBACKUP" /s C:\*.*
  420.  
  421. The following DOS batch file is an example of how you might
  422. use the DualStor return codes and the above DualStor job
  423. files.  Let's call the batch file TAPEOPS.BAT:
  424.  
  425. rem --------Beginning of Sample Batch program-------------------
  426. @echo off
  427. rem
  428. rem Log Retension tape start message to TAPEOPS.LOG file
  429. echo Execute DualStor job file to retension tape >>.\tapeops.log
  430. DUALSTR reten.tpf
  431. rem next statement checks for errorlevel = 1 or greater
  432. if errorlevel 1 goto checkrc
  433. echo Retension tape successful >>.\tapeops.log
  434. rem
  435. rem Log Backup start message to log file
  436. rem Execute DualStor job file to backup C: drive >>.\tapeops.log
  437. DUALSTR mybackup.tpf
  438. rem next statement checks for errorlevel = 1 or greater
  439. if errorlevel 1 goto checkrc
  440. echo Backup of C: successful >>.\tapeops.log
  441. goto end
  442. rem
  443. rem Check which error DualStor found and go process the error
  444. :checkrc
  445. if errorlevel 16 goto nomsgfl
  446. if errorlevel 15 goto noflsckd
  447. if errorlevel 14 goto diskfull
  448. if errorlevel 13 goto diskfull
  449. if errorlevel 12 goto softerr
  450. if errorlevel 11 goto verfyerr
  451. if errorlevel 10 goto tapeerr
  452. if errorlevel 9 goto userabrt
  453. if errorlevel 8 goto nodrive
  454. if errorlevel 7 goto memerr
  455. if errorlevel 6 goto diskerr
  456. if errorlevel 5 goto invcl
  457. if errorlevel 4 goto inctape
  458. if errorlevel 3 goto wptape
  459. if errorlevel 2 goto tapefull
  460. if errorlevel 1 goto notape
  461. rem
  462. rem  Here is examples for a few of the return codes:
  463. rem
  464. :inctape
  465. echo Either the mount failed or the tape is incompatible,
  466. echo Check the tape condition and restart TAPEOPS.BAT
  467. pause
  468. goto end
  469. rem
  470. :notape
  471. echo There is no tape in the drive, please insert a tape and
  472. echo restart TAPEOPS.BAT
  473. pause
  474. goto end
  475. rem
  476. :end
  477. echo End of TAPEOPS.BAT >>.\tapeops.log
  478. rem ------------End of Sample Batch program---------------------
  479.  
  480.  
  481. TAPEOPS.BAT, RETEN.TPF, and MYBACKUP.TPF would all reside in the
  482. directory where DualStor is installed.  The above example would
  483. be executed by typing 'TAPEOPS.BAT' on the command line at the DualStor
  484. directory DOS prompt (\DUALSTOR\TAPEOPS.BAT).
  485.